
Welcome to Issue 2 of The MagPi, a community led magazine keeping you up to date with all things 
Raspberry Pi. 

What a month it has been following the release of issue 1! The interest we received has astounded 
us, with over 100,000 views by readers as far apart as the US to New Zealand and Russia to South 
America. We have had positive reviews from the BBC's Rory Cellan-Jones, the Wall Street Journal 
Tech and many others. Thank you all for your kind words of support and constructive comments. 

Following the release of issue I, some of our readers soon highlighted an error in the logo for Java 
script. We hope that this has not caused too much confusion 
and wish to clarify that the official logo for Java Script is as follows: 
Thank you for drawing this to our attention. 

In this issue of the MagPi we return to the Python Pit to give you more tasty tutorials and tips whilst 
also introducing you to our brand new section, the Command Line clinic. The Scratch Patch will be 
returning in issue 3. We invite you into the world of interfacing, how to install an operating system 
to a SD card and setting up the basics on your Raspberry Pi. There is also more on building the 
skutter robotic arm. If this wasnt enough, we thought we would treat you to a double page spread 
dissecting the pi and much, much more. 

Before drawing this editorial to an end, I would like to take this opportunity to thank not only the 
Raspberry Pi foundation for warmly welcoming us but also the MagPi team and all of its 
contributors for their continual hard work and dedication to producing the magazine. 



We hope you continue to enjoy reading the IsAagPi and that it inspires you to get programming. 





LITTLE BUNDLES DF JDY 



The first orders of Raspberry Pi 
computers are now reaching the 
homes of excited owners. Lucky 
'Steven from Derbyshire' 
managed to snare two of them! 

Steven a.k.a. 'veryevil' ordered from both 
Farnell and RS Components, and both orders 
have been processed. He has loaned one of 
his Pi's to a friend to work on 'Debian Hard 
Floating Point'. 

We have had many reports of other people 
starting to get their orders through. Our very 
own Meltwater now has his - The first of the 
MagPi Team to get his hands on one. This 
means we can start to run our own tests and 
experiments. 



With the computers now in the hands of 
developers and the public, work is rapidly 
progressing. Add-on boards, ported games, 
and a phase of software testing has begun. 

You can expect there to be a flurry of new 
discoveries over the next few months. The 
MagPi will be there to keep you up to speed. 

Article by Jaseman 




Meltwater's own bundle of joy 
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RCA VIDEO AUDIO LEDS 



USB LAN 



There are many ways to setup the 
Raspberry Pi, depending on your 
needs and the peripherals you wish to 
use. 



Power 

The Raspberry Pi uses a micro 
USB power connector, as used for 
most modern smart phones. 



Micro USB Connector 
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HP TouchPad PSU 



The PSU (power supply unit) itself must supply 5V 
and at least 700mA (0.7A). Most 
plug in PSUs will be marked with 
their specific rating, this one will 
supply up to 2000mA (2.0A). 

USB 

The USB ports on the Raspberry Pi are only suited 
to low power devices (-100mA), anything which 
uses too much current will not function correct- 
ly. Therefore, a powered USB hub (a USB hub with 
its own PSU) is recommended, so that all devices 
will have enough power to operate correctly. 

Control 

Direct control of the Raspberry Pi will be through a 
mouse and keyboard. This can be with a standard 
USB mouse and keyboard or with a wireless set 
using a USB RF dongle. A PS2 
keyboard and mouse will need a 
USB adaptor, if you intend to use L °g itech RFDo ^ 
one. 

It should also be possible to use a 
Bluetooth keyboard and mouse, using a 
low cost Bluetooth USB adaptor, but 
some additional setup will be required. 



Bluetooth 
Dongle 



Display 



Li 



TV HDMI Connection 



Your display will depend on what you 
have available to you, most digital 
TVs will have a HDMI connection, 
and newer LCD monitors will often 
have DVI connections (you will need 
to use a HDMI to DVI adaptor). 



I HDMI to DVI Adaptor/Cables: 

I Ensure your DVI connections match as there are 
| several types. Many monitors will only support DVI-D 
| (bottom) with no holes for the four analogue pins DVI- 
| A/DVI-I (top), so an DVI-D adaptor is 
I recommended (this will also fit monitors 
i with DVI-A/DVI-I support). 

I ^ ; HDMI to DVI-D 

Adaptor 



I 
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SDCARD POWER 



Paul Beech ©guru 



I Tip: Although most connections can be made while the 
I Raspberry Pi is powered on, it is recommended that the 
I display and the SD card are only ever connected or 
I disconnected when you have removed the power first. 



~l 



I 



HDMI to VGA convertors are available but they are 
generally expensive (Note: A passive HDMI/DVI to 
VGA adaptor will not work, as the required 
analogue signals are not generated by the 
Raspberry Pi). The analogue RCA output can be 
used to connect to older TVs, small screens or 
video capture devices (approximate resolution 
is 640x480, enough for basic use). If both are 
attached, the Raspberry Pi will default to HDMI. 

Internet Connection (optional) 

The easiest option is to use a RJ45 wired network 
cable directly to your router or modem, however 
with some additional setup it may be possible to 
connect to your Wifi network by using a USB 
dongle. 

Audio Output (optional) 

The HDMI connection will transmit digital audio if 
connected to a TV, however if that is not available 
you can connect via the analogue audio plug. 



Basic Equipment 

1 . Micro USB Charger (rated at 5V 700mA 
minimum), plus micro USB cable if needed. 

2. SD Card (2Gb up to SDHC 32Gb), plus 
suitable card reader. 

3. HDMI Cable/Suitable cable for display 

4. Compatible Mouse/Keyboard 

5. Powered USB Hub (required for high 
powered USB devices) 

Network Cable and audio leads if required 



Recommended HW see: http://elinux.org/RPi VerifiedPeripherals 
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Example Hardware Setups 



HDTV Setup 

PH Power : Micro USB Charger 

[b] SD Card : Standard Size SD Card 

[c] HDMI : Connected to HD TV HDMI input for 
1 — 1 1 080p & digital audio 

[p| LAN : Wire connection to network hub/switch 

|"e] USB : Wireless RF Dongle for Mouse and 
Keyboard 





LCD Monitor Setup 

PH Power : Micro USB Charger 

[b! SD Card : Micro SD card with Full Size Adaptor 

jc] HDMI : Connected to HDMI to DVI-D adaptor, 
'— ' then into monitor DVI input for 1 080p (no audio) 

fp| LAN : Wire connection to network hub/switch 

[e] USB : USB Mouse and USB Keyboard 

[■pi Audio : 3.5mm Audio out to speakers/ 
*— ' headphones 



L i it: 



Video Out Setup 



[a! Power : Micro USB Charger / High Capacity Mobile 
Battery (rated output at 5V 700mA or more) 

[b! SD Card : Micro SD card with Full Size Adaptor 

RCA Video : Connected to either TV AV In/SCART adaptor 
(European-TV connection)/USB Video Capture Device 

Audio : 3.5mm Audio Jack to Phono 



0 



connections allows audio to be 
connected along with the video 

USB : Bluetooth Dongle for con 
nection to Bluetooth Keyboard/ 
Mouse, Wifi Dongle for wireless 
connection to network 
(probably powered USB Hub 
and additional 
setup required) 




More information see the Wiki Pages: http://elinux.org/RPi Hardware Basic Setup 



Article by Meltwater 



SDCard Setup 



Download your preferred Operating System (OS) you 
wish to run, from the raspberry pi website: 
http://www.raspberrypi.org/downloads 

• The download page includes instructions for carrying 
out file corruption checks (using SHA-1 checksums), 
recommended to avoid problems. 

• Take note of the username and password related to 
the particular image you have selected, you will need 
this when you run it. 

^You will need: 

1 

I* SDCard 2Gb or larger (Depending on OS and other 
requirements) 

Suitable SDCard reader (some built in card readers ■ 
have issues so a USB card reader is recommended) | 

PC running Linux/Windows or even a Raspberry Pi! i 
(If using Raspberry Pi use powered USB hub with a 
SDCard reader to write the image to a new card. 
Warning, it will be very slow this way!) 



i- 
i- 



The following instructions apply to the debian6-i9-04- 
2012 . zip file, but the steps should be similar whichever 
package selected. 

Once you have written to your card, you are ready to boot 
your Raspberry Pi (see guide later on). 

To reinstall the Operating System or to select a different 
one, simply repeat the process. 



NOTE: ^&Lf 




Ensure the SDCard mr\ 




write "Lock" is 

disabled! Writable 


Read Only ] 



SDCARD SETUP WITH WINDOWS 
Extract the image file to your hard drive 

For ZIP Files: Explore using windows and copy and 

paste contents out to your hard-drive. 

For tar/bz2 Files: Use PeaZip ( www.peazip.org). 

You'll need at least 2Gb of space to extract the file. 
You should end up with a .img file (this contains all the 
parts of the Operating System which needs to be writ- 
ten to the card). 

Write the image to the SDCard 

You will need to use a program such as Win32Disklm- 
ager (available from: 

http://www.raspberrypi.org/downloads ). This program 
will write the image structure required for the Raspberry 
Pi to boot to the SDCard. 

Insert your SDCard into the card reader (also remove 
any other drives/devices you may currently have at- 
tached to avoid wiping the wrong device by mistake). 



Win32 Disk Imager 



Image File 



Open up the Win32Disklmager program 



a) Select the .img file you 
extracted previously, by 
clicking on the small 
folder icon (and browsing 
to where you extracted 
it). 



c; - y - -3 , - - : - 

□ MD5 Hash: 

F regress 



b) Select the device 
letter which relates to 
your SDCard (if in doubt 
double check this letter 
in Windows Explorer, as 
the process will remove 
all data on whatever drive you select). 




%: Win32 Disk Imager 



Image File 

C:\temp\debian6-19-04-2012.img 

□ MD5 Hash: 
-Progress — 



c) Press the write 
button, and you will see 
the program start to write 
to the SDCard. Note, you 
can also use Read, to 
backup your SDCard! 



To see the result, 
you can open up the 
Disk Management 
program built into 
windows. 



_ 



Type the name of a program, folder, document or 
Internet resource, and Windows will open it for you. 



a) Press windows 

key + r or select 

Run . . . from the Start Menu. 



Computer Management 



File Action View Help 



Computer Management 
J System Tools 
i> 0 Task Scheduler 

> Q Event Viewer 
t> jsi Shared Folders 
1 4 Local Users and Gn 

> ® Performance 

-.5a Device Manager 
- & Storage 

^ Disk Management 
[> 5b Services and Applicat 



s and Applications 



Computer Managem... A 
More Actions ► 



b) Type compmgmt .msc and press OK. 

c) You will see the above window come up, select 
the Disk Management component, Storage and you 
should see your drives, include the SDCard with 
several partitions on (most likely 3) 

- boot: viewable through windows 

- OS System: not viewable through windows 

- OS Swap drive: also not viewable 

- Plus any unallocated space at the end (see guide 
on resizing this). 



— Disk 1 










Removable 


(F:) 








7.29 GB 


75 MB FAT3; 1.55 GB 


191 MB 


5.47 GB 




Online 


Healthy (Prir Healthy (Primary Partiti 

1 


Healthy (Primar 


Unallocated 
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SDCARD SETUP WITH LINUX 

Note: These steps should apply to most common versions of Linux 
(Screenshots are from RacyPy (Puppy Linux) MagPi - Issue 1) 

Extract the image file to your hard drive 

Locate your downloaded OS file in your file manager, 
remember you'll need at least 2Gb of space to extract 
the .img file. 

GUI programs such as XArchive (pre-installed on 
RacyPy) will allow you to locate and extract the .img 
file directly. 





rf? Select All 
fSl UnselectAll 




p K 

Open New Close I Selet 


Extract Open With... 


/mnt/sdbl/debian6-19-04-2012.zip & | 


Open With... 




Rle 


= Remove 
+ Add 


| Permissions | User | Group 


£i debian6-19-04-2012/ 


drwxr-xr-x 0 o 


Q debian6-19-04-2012/debian6-19-04-2012.img 


Shi - 65 -rwi-r--r- 0 o 




LU 1 ±J 



IS unzip ctebian6-19-04-2012.zip 
flrch ive: deb ian6 - 19 -04 -2012 .z ip 
creat ing I deb ian6 - 19 -04-20 12/ 
inf lat ins: : deb ianb -19-04 -20 12/deb ianb - 19-04 -20 12 . ing .sha 1 
nflal li i deb -,--1 i 01 debianb-1 0 01 n 



Or using 

this command in a termi- 
nal window: 

unzip filename.zip 

The "filename.zip" should match the source file. 
Note it'll take a while to extract the files. 



Open a terminal window: 

You can normally open a terminal window 

directly from the file-manager. 

i.e. RacyPy/Puppy ROX-Filer 

right-click, select Window -> Terminal Here 

In Debian open the File Manger and press F4 



Identify your SDCard device name 

Before you plug in your card reader and SDCard, take 
note of any devices you may already have plugged in/ 
installed. You can usually see icons on the desktop, 
or run this command in a terminal window. 

df -h 



tt df -h 

Filesystem 

trapfs 

/dev/srO 

/dev/loopO 

/dev/loop3 

unionfs 

shmfs 

/dev/sdal 

# I 



Size Used fivail Use% Mounted on 

124M 3 + 5M 12 1H /initnd/pup_nw 

385M 385M 0 100% /initrd/mnt/dev_ro2 

265H 265M 0 100% /initnd/pup_no2 

25M 25M 0 100% /initnd/pup_z 

124H 3,5M 12 1M 3£ / 

5SH 0 58H 0% /dev/shm 

15G 7,5G 7.5G 51% /rnnt/sdal 



* SI 



fdO srO sdbl 



Attach your SDCard Reader with the target SD Card 
inserted. On RacyPy/Puppy, you will see an extra 
USB icon has appeared (or browse through the file- 
manager), open it (this will "mount" it). 



£# df -h 

Filesystem 

tmpfs 

/dev/srO 

/dev/loopO 

/dev/loop3 

unionfs 

shmfs 

/dev/sdal 

/dev/sdbl 

# I 



Size Used Avail Use% Mounted on 

124M 3 + 6M 121H Z% /initrd/pup_rw 

3S5M 3S5M 0 100% /initrd/rnnt/dev_ro2 

265M 265M 0 100% /initrd/pup_ro2 

25M 25M 0 100% /initrd/pup_z 

124M 121H 3% / 

5SH 0 5SH 0% /dev/shm 

15G 7 + 5G 7 + 5G 51% /mnt/sdal 

3.SG 32K 3,SG 1% /mnt/sdbl 



Re-run: 

I df -h tO 

confirm that 
this is the 
new drive. 




In this case, we can see we have added drive "sdb", 
the partition "sdbl" is 3.8Gb and 32K used - this 
matches what we expect to see for this SDCard. 



Unmount" the partitions 



| | Run Pmount Puppy Drive Mounter 

G Run Desktop Drive Icon Manager 



] Unmount ALL mounted partitions 

ROX-Filer 

App dir 'sdbl' 

Edit Item 
r_£' Show Location 
■=■ Remove ltem(s) 

% Backdrop... 
Add Panel 



You now need to "unmount" 
the device (this closes the 
drive so that the program is 
able to write to it). 
In Puppy/RacyPy, you can 
right click on the drive icon 
and select "Unmount sdXY 
(if currently mounted)". 
If you've used the card before, you may have multiple 
partitions, so ensure you "unmount" them all. 

Or using this command in a terminal window: 

umount /dev/sdbl 

Where sdbl is name of the device partition above. 



Write the image to the SDCard 

Locate the directory which contains the extracted .img 
file and open a new terminal window. 

Write the image with the following command (where: 
sdx should match your device name - without the 
number at the end). 

Take care on this step, since this command will over- 
write all the data on the drive, so ensure you get the 
right drive. 



# sudo dd if =debian6- 19 -04-2012. img of=/dev/sdbl bs=lM 
1859+1 records in 
1S59+1 records out 

1950000000 bytes (2 + 0 GE) copied, 217.535 s, 9.0 HB/s 
tt I 



sudo dd if =f ilename . img of=/dev/sdX bs=lM 

sudo - allow permissions to write to the SDCard device 

dd - disk-to-disk program 

if - input file or source drive 

of - output file or target drive 

bs - size of blocks to use during copy (1M is fine) 

r 

I Advanced Tip: You can also use dd to backup your SDCard: 

| sudo dd if=/dev/sdX | split -d -b 2000m - image . split 
I 

I To restore the split image (splitting avoids oversized files): 

| sudo cat image . split* | dd of=/dev/sdX bs=lM 



Writing the image to the SDCard will take some time 
(lookout for the card reader activity light flashing), linux 
will report when the process is completed. 

Remove and reinsert the SDCard to confirm there are 
now two new partitions visible on the card (sdal Boot) 
and (sda2 Operating System), there is also a third 
hidden swap partition too. 



If you run into problems creating your SDCard, 
additional help and instructions are available on the 
Raspberry Pi Wiki (Mac instructions also available). 
http://elinux.org/RPi Easy SD Card Setup 
If you have general problems, take a look at the 
troubleshooting section. 
http://elinux.org/R-Pi Troubleshooting 

Article by Meltwater 



Partitions 



In order to maximise the use of the SD-Card, 
it is recommended that the main partition of 
the card is enlarged to fill up the remaining 
"unallocated" space on the card. 

Since Windows is unable to manipulate the Linux 
formatted partitions you now have on the SDCard, we 
need to use a Linux partition management program, 
such as G Parted. 

If you don't have computer running Linux, you can use 
a LiveCD or VM (Virtual Machine), such as 
Puppy/RacyPy, Debian (We covered using these in 
Issue 1 of The MagPi). 

There is even a specific GParted LiveCD, available 
with instructions on how to use it: 

http : //gparted. source forge . net/livecd.php 

If GParted is not already installed on your Linux 
system, it can be installed with the following command 
in a terminal window: 

sudo apt-get install gparted 

Alternatively, it is possible to use a USB SDCard 
reader with a powered USB Hub to repartition a 
SDCard directly on the Raspberry Pi, but you will 
need a 2nd SDCard for the RPi to run from while you 
do this. Again, this will take a long time to perform the 
changes. 

Running GParted 

Start GParted from the start menu, (for Puppy/Racy Py 
it is located in the System section). 

Alternatively, you can start the program using terminal 
prompt by typing (you will need to use this method on 
the RPi): sudo gparted 

If prompted, enter your user password to give the pro- 
gram admin rights. 

When the GParted utility scans the drives and loads, 
click the dropdown box in the upper right hand corner, 
and you should see an entry which matches your SD 
card (if you are unsure, add/remove the card and res- 
can - by pressing ctrl+R or via the "GParted" menu, 
"Refresh Devices" until you determine which one it is). 



Disclaimer: We are going to be altering disk parti- 
tions, so you MUST make sure you've selected the 
right disk (card in our case). If your screenshot 
differs vastly from that below, stop and ask your- 
self some stern questions before continuing. I'm 
not going to be responsible if you end up mucking 
about with your installed system. Remember al- 
ways, you are running this as a super user. 
Please be careful. 



/dev/mmcblkO 

GParted Edit View Device Partition Help 


- GParted 






i 










/dev/mmcblkO (14.92 GiB) ; 












unallocated 
12.87 GiB 


— . 








| Res can Option 




1 Drive Selection 1 
















Partition 


File System 


Size 


Used 


Unused Flags 




/dev/mmcblkOpl H*at32 


75.00 MiB 


28,03 MiB 


46.97 MiB Iba 


unallocated 


unallocated 


1.00 MiB 
1.79 GiB 








/dev/mmcblkOp2 | ext4 


1.30 GiB 


500.45 MiB 




/dev/mmcblk0p3 ■ linux-swap 


191.00 MiB 








unallocated 


O unallocated 


12.87 GiB 







You can now see the layout of your SD card. You 
should see 3 partitions in the top part of the window 
(Green, orange and red in the above screenshot). We 
have a small boot partition, your 1.8gb home partition 
and a swap partition. What we need to do is to move 
that swap partition all the way to the right, and then 
stretch out the home partition to make it bigger. 

Move the swap partition. Right click on the third par- 
tition and choose Unmount/SwapOff. Then right click 
it again, and choose Resize/Move. You'll see this 
screen: 



Minimum size: 1 MiB Maximum size: 13371 MiB 

Free space preceding (MiB): 
New size (MiB): 

Free space following (MiB): ' 13180 
Align to: 



191 



MiB 



Cancel 



+1 Resize/Move 



In the Free space following (MiB) type 0 and press 
enter, or grab hold of the partition (at the top) with 
your left mouse button, and drag it all the way to the 
right: 



Minimum size: 1 MiB Maximum size: 13371 MiB 

Free space preceding (MiB): !|l3180 
New size (MiB): 
Free space following (MiB): 
Align to: tr" 



191 



MiB 



Cancel 



I -M Resize/Move | 



Click Resize/Move. A warning will pop up stating that 



this may cause your operating system to fail to boot. 
Ignore this, and click Ok. 

Stretch out the home partition. Right click on the 
second partition in the top of the window (the biggest 
partition), and again choose 

Unmount. Right click it again, and choose Res- 
ize/Move. You'll see this screen: 



(L 



Minimum size: 1331 MiB Maximum size: 15012 MiB 

Free space preceding (MiB): 
New size (MiB): ^ 
Free space following (MiB): ' 13180 
Align to: 



1831 



MiB 



Cancel 



■*H Resize/Move 



Grab the little arrow to the right of the partition with 
your left mouse button, and stretch it all the way to the 
right: 



> 



ii 



Minimum size: 1331 MiB Maximum size: 15012 MiB 

Free space preceding (MiB): 
New size (MiB): 
Free space following (MiB): 
Align to: 



115012 



MiB 



Cancel J | -N Resize/Move | 



Choose Resize/Move. 

Your screen should now be like this (please note that I 
have a 16GB SD card here, you may have one of a 
different size): 



/dev/mmcblkO - GParted 

GParted Edit View Device Partition Help 

■P * +I ID e * 



i — /dev/mmcblkO (14.92 GiB) 



/dev/mmcblk0p2 
14.66 GiB 



Partition File System Mount Point 

/dev/mmcblkOpl _| — fat32 /media/95F5-0D7A 
unallocated unallocated 
/dev/mmcblk0p2 ■ ext4 
/dev/mmcblkGp3 - — linux-swap 



Size Used Unused Flags 

75,00 MiB \ 28.03 MiBi 46,97 MiB \ Iba 

1.00 MiB — i 

14,66 GiB | 1,30 GiB \ 13,36 GiB; 

191.00 MiB; — ; 



Move /deWmmcblk0p3 to the right 

Grow /dev/mmcblk0p2 from 1.79 GiB to 14.66 GiB 



2 operations pending 



Now we need to write the changes to the card. 
Open the Edit menu and choose, Apply All Opera- 
tions. 

You will now see a confirmation box. Click Apply. 



Wait for GParted to complete the operation (this may 
take a minute or two, depending on the speed of your 
SD card). When it's finished, click OK and the close 
GParted. 

You may now safely remove the SD card from your 
doner computer and put it back in your Raspberry Pi. 
Boot your Raspberry Pi and enjoy your new larger 
home partition! 

Article by Pete / Meltwater 



First Boot 

You have all your hardware, you've connected those 
wires (all except the power), you've prepared your 
SDCard and you are ready to go. Remember, keep it 
simple and only connect the minimum hardware at 
first until you are happy everything is running 
smoothly (ideally the keyboard/mouse should be 
connected through a powered USB hub if available). 

Double check everything, switch on your display, and 
now plug in the power! 

You should see the Red PWR LED light up and within 
the count of 10, the OK light should start to flash 
activity. On your display, you will see lots of text 
scrolling down the screen, this is the Raspberry Pi 
initialising, the first time it will take longer as it 
configures itself (do not worry if you see 3x failed! 
related to NFS, this is fine) and resets. If you are 
using a TV and the text doesn't fit on your display, try 
changing the Aspect Ratio settings (i.e. 4:3, 16:9, 
Widescreen etc) or if you still have issues check the 
Wiki (http://elinux.org/R-Pi_Troubleshooting). 

You should end up with a prompt similar to the 
following, 

Debian GNU/Linux 6.0 raspberrypi ttyl 
raspberrypi login: 

You'll need to enter the username and password for 
the particular distro you downloaded (the password 
won't show anything when you type, but will accept it 
after you press enter). 

Finally, to start a new graphical session, type startx 
If you want to power down, select __ shutdown from 
the bottom right corner in the graphical session, or 
type sudo shutdown -h now from the command 
terminal. 

If you have made it this far congratulations! The proof 
of the Pi really is in the eating. 
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INTERFACING PROJECTS FOR BEGINNERS 



BY DARREN GRANT 

If you want a change from playing games or browsing the internet, what else is there that 
you can do with a computer? What I would like to share with you is the tremendous fasci- 
nation of using a computer for control. You can get the computer to switch things on and 
off, respond to events and take a variety of measurements. This is known as Interfacing'. 



If you feel your knowledge of electronics is 
rather limited, don't despair in this series we 
are not assuming that you have more than a 
basic understanding of electronics. The aim 
is to explain the basics and provide details of 
relatively simple hardware and basic software 
to get started. 

The Raspberry Pi provides an ideal way to be- 
gin experimenting. Not only does the low cost 
of the Pi mean that there is no need to worry 
about damage to an expensive computer, it 
also comes ready equipped 
with the connections to get 
started right away. 

As you will have no doubt 
probably figured out al- 
ready computers are all 
about In's and Out's. Input 
something on the keyboard 
or click with a mouse and 
get something out on the 
screen or sound out of the 
speakers. Interfacing is 
simply finding other ways 
of getting information in 
and out of the computer. 

The first thing to understand is that the basic 
building blocks of a computer are made up of 
millions of switches called transistors. Com- 
puters see everything as either on or off so 
when you click the mouse button the switch is 
on and when you let go it is off. The computer 
has no idea how hard the button has been 
pressed. This is known as a digital binary 
system, when a switch is on it is represented 
by a T (one) and when it is off a '0' (zero). 
Signals that are variable such as measuring 




temperature are called analogue, as they are 
more complicated than just a simple on or off 
state extra equipment is needed so the com- 
puter can read them. 

For now we will stick with a simple digital inter- 
face. The Raspberry Pi has a set of connec- 
tions called the GPIO (General Purpose Input 
Output) port. GENERAL PURPOSE means 
that they have not been assigned a specific 
purpose, unlike for example the speaker con- 
nection that has a well defined purpose. The 
connections on the GPIO port 
can be used for whatever pur- 
pose you like. Each connec- 
tion can be used as an INPUT 
where the computer is waiting 
for an event to happen such 
as a switch being pressed or 
an OUTPUT where the com- 
puter is sending a signal out 
for example to switch a light or 
buzzer on and off. 

The GPIO ports on the rasp- 
berry Pi are low powered so 
an expansion board is recom- 
mended to provide higher powered signals that 
can be used for controlling things like lamps, 
buzzers and motors. A GPIO expansion board 
also provides some protection to the Rasp- 
berry Pi just in case something is connected 
incorrectly. 

Don't worry if you don't have a GPIO expan- 
sion board at this stage and you are raring to 
get going with your first experiment. Providing 
you take care we can start with a simple cir- 
cuit using a switch and a LED (Light Emitting 
Diode). ► 
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IMPORTANT 

Before connecting anything to the Raspberry Pi 
please be aware that incorrect connections could 
cause damage. Please take care. 



Switch Types 

An electrical switch is used to 
make or break an electrical 
circuit. Switches are binary 
devices: they are either com- 
pletely on (closed) or completely off (open) 
making an ideal starting point for our interfac- 
ing experiments. There are many different 
types of switches, the simplest type being one 
where two electrical conductors are brought in 
contact with each other by manually moving a 
mechanism. 

There are essentially two common types of 
switch, latching switches and momentary 
types. A latching switch stays open or closed 
when activated, for example a light switch; 
when you switch the light on or off the switch 
stays in the same position until you switch it 
again. A momentary switch on the other hand 
will only operate while pressure is being ap- 
plied and will return to its previous state when 
released. Momentary switches can be found 
on a game controller where the control only 
responds while the button is being pressed. A 
momentary switch wouldn't make a very good 
light switch as you wouldn't want to have to 
keep the button pressed to keep the light on. 
The electrical symbol for a simple momentary 
push switch is like this. 



We will use a small momentary push button 
switch for this experiment, known as a nor- 
mally open tactile switch. 

LEDs 

LEDs (Light Emitting Diodes) can 
be found everywhere, commonly 
used as indicator lights on 
most electronic equipment 
such as the standby light on 
your TV. Due to the small 
amount of power needed to make a LED light 
up, we can safely use them in our experiment 
without damaging the Raspberry Pi. 



The symbol for a LED looks like this. 




To save soldering wires together a bread- 
board and a selection of jumper wires is highly 
recommended, it makes connecting things 
together very easy and flexible. The grid refer- 
ence numbers are laid out on a small 270 point 
Tandy breadboard. If you have a bigger board 
that will work just as well but the reference 
numbers may not match so will need to be 
modified if your board has a slightly different 
grid layout. 

Place the components on the breadboard us- 
ing the illustration as a guide. If your tactile 
switch has inward pointing legs like the one 
shown in the photo on the top left, use a small 
pair of pliers to straighten them. The switch 
needs to be inserted into the breadboard so 
that the legs are on the left and right edges. 
It is also important that the LED is connected 
the correct way round, the positive terminal 
called the anode is the longer leg and should 
be connected to point C4. Once all the com- 
ponents are in place connect the circuit to the 
Raspberry Pi using 3 female to male jumper 
wires, taking extra care to connect the correct 
terminals. The Raspberry Pi GPIO pins in 
the illustration are shown when 
looking at the board with 
the GPIO header in the top 
left corner, as shown in the 
photo in the Pi Dissection 
article on page 16. 



i GPIO pins in 
when 



Having connected everything together, power 
up the Raspberry Pi and try pressing the but- 
ton, the LED should light up. If it doesn't work 
check that all the components and wires are 
connected correctly, paying particular atten- 
tion to the LED. If the LED stays on without 
pressing the button then the switch is prob- 
ably connected incorrectly and will need to be 
turned 90°. ► 
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Circuit Description 

Because the Raspberry Pi GPIO port is not pro- 
tected with a buffer, we have included a 1 KQ (Ohm) 
resistor (R2) between the switch and the GPIO pin 
as a precaution to prevent damage if the GPIO port 
is accidentally set as an output. Our tactile switch is 
connected to the 0V or ground line so that when it is 
pressed the circuit is completed between the GPIO 
pin and zero Volts. 

The LED along with a 470Q current limiting resistor 
(R1) is connected to the 3.3V positive rail. Pressing 
the switch completes the circuit between the LED 
and 0V causing it to light up, this provides a visual 
indication when the switch is pressed. Finally we 
have a 10KQ pull-up resistor (R3). 

Digital Logic States 

As mentioned earlier computers see the world as 
a series of zeros and ones. The Raspberry Pi uses 
3.3V CMOS logic meaning that a binary 1 is created 
by applying a voltage of 3.3V to an input. When the 
voltage is present it is referred to as a logic HIGH 
state. Alternatively when the GPIO pin is connected 
to 0V a binary 0 or logic LOW state is created. In 
our switch example pressing the switch creates a 
LOW state by connecting the IO port to OV ► 



^3.3V > 
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Shopping List 

COMPONENTS 

lx 3mm Red LED (standard brightness) 

lx 470Q Resistor 

lx lkQ Resistor 

lx lOkQ Resistor 

lx Miniature PCB Tactile Switch 

ACCESSORIES 
lx Breadboard 

3x Male-female jumper wires 

lx Selection of short jumper wires 

TOOLS 

If you don't have them already then 
a set of small long nosed pliers for 
bending component leads and wire 
cutters will make construction easier. 



Digital logic in fact has three possible states 
known as Tri-State logic. We have already 
discussed HIGH (+3.3V) and LOW (OV) states 
but we also have a third state that is called 
FLOATING. Basically floating means the state 
is not clearly defined, attempting to determine 
the status of a connection that is floating may 
result in unpredictable results. You might be 
thinking that if the pin is not connected to a 
voltage it must be low: the problem is we can 
not guarantee that we will get a reliable LOW 
signal by simply relying on the absence of a 
voltage on the pin. 

To illustrate the problem, imagine that we hold 
a piece of ribbon between two gate posts, the 
two gate posts would be connected by the rib- 
bon. Now if we let one end of the ribbon go and 
allow it to fall to the ground the two posts are 
no longer connected. But what happens when 
the wind blows? The ribbon will flap around 
where sometimes it will be in contact with the 
ground and other times it will touch or even be- 
come entangled with the other post. To prevent 
the ribbon moving in the wind we would tie it 
either to the ground or the post so it wouldn't 
move unless we wanted it to. We need to do 
the same thing with a logic circuit, to avoid 
unpredictable behaviour we tie the connection 
to either 3.3V or OV using what is known as 
a pull-up or pull-down resistor that effectively 
creates a default state. In this experiment we 
have used a pull-up resistor so the 10 port will 
always be connected to +3.3V making it the 
default state. In our example when reading the 
state of the 10 pin it will always be high until we 
press the switch that will change it to low. 

Software 

Having completed the circuit construction we 
now have to get the Raspberry Pi to recognise 
the switch. To do this we need to create a soft- 
ware program that will instruct the Pi to monitor 
the switch status. 

We will be using the Python programming lan- 
guage to write our program. It is assumed that 
you are using the standard Debian "squeeze" 



operating system from the Raspberry Pi web- 
site. If you have not used Python before take a 
look at the guide to editing and running Python 
programs on page 24. 

The first thing we need to do is install a Python 
package that adds the capability to Python to 
control the GPIO pins on the Raspberry Pi. 
Download the Python package from 
http://pypi.python.org/pypi/RPi.GPIO the latest 
version at the time of writing this article is RPi. 
GPIO-0.2.0. If the file version downloaded is 
different then the instructions below will need 
to be modified to use the version number you 
have downloaded. 

We will use the terminal to install the package, 
to open the terminal go to the main menu, select 
accessories and click on LXTerminal which will 
open a new window with a command prompt. 
The file is compressed and archived, to install 
it we will need to decompress and unarchive it 
by typing the following commands. 



r 

gunzip RPi .GPIO-0. 


2. 


.0. 


.tar.gz 


tar -xvf RPi .GPIO- 


0. 


.2. 


.0. tar 



We now have a new directory called RPi. 
GPIO-0.2.0 that we need to go into and run 
the setup script, type the following commands 
to complete the installation. 



cd RPi .GPIO-0.2.0 

sudo python setup. py install 



You may be asked for your password when run- 
ning the install script. If you have not changed 
the password the default is 'raspberry'. 

Now that the package installation is complete 
we can write a program to monitor the switch 
and write something to the screen each time 
it is pressed. Before we start programming: at 
the command prompt type the following com- 
mand to return to the home directory. ► 



cd 
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Python Program 

Create a new text file named mybutton.py and 
enter the following program. 

#! /usr/bi n/python 
import time 

import RPi .GPIO as GPIO 
GPIO.setupUl, GPIO. IN) 

while True: 

mybutton = GPIO. input (11) 
if mybutton == False: 
print "giggle" 
time . sleep( . 2) 



Program Description 

We start by including the time and RPi. GPIO 
packages in our program so we can make use 
of their functions by using import. 

Next we configure GPIO pin 11 on the rasp- 
berry Pi as an input so it can detect the switch. 

By using 'while True' we create a never end- 
ing loop so that everything below this will be 
repeated until we choose to stop it. 



To start the program type the following com- 
mand into the terminal window. 



sudo python mybutton.py 



When you have had enough giggles press the 



Control+C keys to stop 
the program. 




Counting 

Try the following program to count the number 
of times the button is pressed. 

#! /usr/bi n/python 



import time 

import RPi .GPIO as GPIO 
GPIO.setupUl, GPIO. IN) 
count = 0 

while True: 

mybutton = GPIO. input (11) 
if mybutton == False: 
count = count+1 
print "count" , count 
time . sleep( . 2) 

Conclusion 



Our program keeps checking the status of pin 
11 that will always be True (High) while the 
button is not being pressed. As soon as the 
button is pressed the GPIO pin goes low and 
our result will be False: at which point we print 
out the word "giggle" on the screen. Because 
the program runs much quicker than we can 
press and release the button we add a small 
0.2 second delay before checking the button 
status again so that the screen does not fill up 
with giggles. 



We have covered how to make the computer 
respond to a switch circuit and written a sim- 
ple program. Now that you have mastered 
the basics how about you try and improve the 
program. For example make a timer program 
that will start and stop counting when press- 
ing the button. Why not send in your programs 
and questions to in.control@themagpi.com or 
get involved on the official Raspberry Pi forum, 
maybe we can include some of them in the 
next instalment. • 




www.tandyonline.co.uk 



This article is sponsored by Tandy. 

Look out for our new web site coming soon: where you wil 
find all the components you need for your Raspberry Pi 
interfacing projects and much more. 



STOP THE PRESS! 



EXCLUSIVE 
INTERVIEWS 

Do you have R-Pi questions that you just can't find the answer 
to? 

Have you searched and searched the forum with no avail? 
Don't fret, the MagPi is here to help! 



We are pleased to announce that we are lucky enough to have an 
exclusive opportunity to interview both Eben and Liz, the King and 
Queen of the Raspberry Pi. 

If you have a question that you want us to put to those at the top of 
the foundation, please contact us at editor@themagpi.com and look 
out for this exciting article in the near future in The MagPi. 
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Dissection 



2V5 Pin 5 of RG3 
(LP2980 Voltage 
Regulator) used 
for Composite 
Video Out 



USB Gnd (TP2) 

Ground pin of Micro 
USB Power Supply 







TP2 \ 


3 



DSI (Display Serial Interface) (S2) 

This will support direct connection to add-on screens 
(when available) 




SC Card Socket (S9) 

On power up, the Raspberry Pi will 
load the operating system directly 
from a suitably prepared SD card. 



Micro USB Power (S1) 

Only Pin 5 Ground and 
Pin 1 5V are connected 
(no data or ID) 



PCB — Printed Circuit Board 

The components are connected through 
6-layers of tracks sandwiched together 
and connected through "vias" (holes 
through the board). One layer, called the 
"Ground Plane" (OV) is used to shield the 
densely packed signals, and separate 
high-frequency data from sources of 
interference. 



5V In (TP1) 

5V supply after 
the 1A1 Polyfuse 
(F3 fitted on rear) 



Tip: Engineers often use 3"V"3 notation in electrical drawings (schematics) to indicate 3.3V or 1K2 (=1200) to ensure 
the decimal point is clearly marked (mistaking 33V instead of 3.3V would be a big problem). 
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Composite Video Out & Analogue Audio 

Signals are generated internally by the SoC 
using on-board DAC (digital to analogue 
converter) for video and a smoothed PWM 
(pulse width modulation) signal for each right 
and left audio channels. 



LED Lights (D5-D9) 

Status OK (D5 Green) [BCM GPI016] 
Power On (D6 Red) [3.3V Supply] 



Full Duplex (D7 Green) 
Link (D8 Green) 
100M (D9 Yellow) - 
100Mbps when lit! 





r/ 



140mA Polyfuses (F1 & F2) 

Limit the current drawn by 
USB devices. 



LAN (Local Area Network) Chip (IC3) 

The LAN9512 is connected via the SoC's USB 
interface and provides 10/1 00Mbps wired LAN 
and dual USB connections. Model A of the 
Raspberry Pi, will have the SoC's USB connec- 
tion connected directly to a single USB socket. 



Hynix 256Mb SD-RAM - Wired directly on top of the 
Broadcom BCM2835 chip using PoP (Package on 
Package) method, this reduces the required footprint by 
avoiding 68 pin connections related PCB tracks. 

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

Under the RAM, is the Broadcom SoC (System on Chip), 

containing 700MHz ARM1 1 (ARM1 1 76JZF-S) CPU 
(Central Processing Unit) and VideoCore IV GPU (Graphical 
Processing Unit). The SoC's 300 pins are arranged in a grid 
(BGA - Ball Grid Array) allowing the physical size of the chip 
to be as small as possible. Each of the required pins are 
routed through one of the 6 PCB layers to the surrounding 
peripherals. 



CSI-2 (Camera Serial Interface) (S5) 

This will allow connection to add-on camera modules (when 
available). The GPU is potentially able to handle up to 40MPixels 
stills and 1 080p 30 fps (frames per second) video capture. 



The "wiggles" in tracks, ensure signals are matched 
electrically, reducing interference and signal delay. 
This is particularly important for high speed video 
data and HDMI signals. 



Information given as a guide 
Compiled by Meltwater 
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SKUTTER 



Bytzj 




Bodge N Hackitt has been unable to 
provide us with part 2 of his Skutter 
project this month, due to exams 
and family commitments. But he 
will be back! 

In the meantime, tzj has bravely 
taken up the challenge of making 
his own Skutter. He purchased the 
OWI robotic arm kit, and is going to 
share with us his experience of 
putting it together. So you can 
consider this article as 'Skutter Part 
1.5' 




The plastic airfix-like parts are a little tough 
to get through when clipping parts out, so 
adult supervision is advised. 




The nuts for the gear boxes are a bit of a 
fiddle to put in but so long as you have long 
nosed pliers, you should be ok. 




Wires at the motors are really hard to push 



(8 



into the clips, a thin flathead screwdriver 
does the trick. 




To make my assembly easier I also built the 
gripper gear assembly at the same time as 
the other gear assemblies. 




The base was fairly easy to assemble, 
though wire routing is a challenge in places. 




Note - 3v is taken from the middle 
(large) battery terminal. So I suggest 
you don't go out and get a 6 volt lantern 
battery to save money just yet, like I did. 




The software works but isn't optimised for 
larger screens. I had to download the 
64-bit software and driver for it to work. 



I had my next door neighbour's 4 year old 
son playing with the arm; once he got used 
to using it properly (rather than attempting 
to manualy move it), he had a lot of fun. 
However, he did have better control over it 
using the mouse rather than the keyboard. 

After getting out my scales, the arm's 
weight with the batteries in is 1.155Kg, and 
the arm can lift 0.176Kg (the recommended 
weight is O.lKg), but it is unstable. The 
motors start to pull on the weighted side 
but nevertheless still hold. 

It may be useful as an helping hand, so long 
as it's angled in such a way that the weight 
is near the centre and the object isn't more 
than double the recommended weight. 

Some modifications to make it more stable 
under load may be required, so that it can 
perform better under those conditions. 

There is an extra disk you can buy which 
offers activities to do with the arm, but it's 
more money. 

Overall I really enjoyed building this part of 
the project, and I hope I helped others to 
have a go at building it too. 
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Command/) Line Clinic 




By Bobby Redmond (bredman) 



Welcome to the Command Line 
Clinic. 

This is the first in a series of 
articles to help you to start using 
the command line interface of 
your Raspberry Pi. 

Your computer needs guidance. Without a 
human to tell it what to do, it will just sit there 
and sulk. You can click with your mouse, you 
can prod your finger on a screen, or you can 
type commands on a keyboard. These are all 
just ways to tell your computer what to do. 

The command line fills new users with dread. 
It can be very intimidating. Somebody who 
just clicks icons and buttons with a mouse will 
expect helpful messages and gentle feedback. 
A command line spits out gibberish and seldom 
reports that a command has been successful. 

So why do Linux users insist on using the 
command line? The funny thing is that Linux 
contains lots of fancy tools that you could use 
instead of the command line. So why is the 
command line so popular? 



First, the command line gives you the power to 
do anything you wish. A graphical tool will only 
support a common task that a lot of people will 
use. If you need to do something different, 
you may not be able to find a graphical tool to 
do the job. 

More importantly, you cannot assume that the 
correct graphical tool will be available when 
you need it. As an example, have you noticed 
that the standard Raspberry Pi Debian image 
has no tool to change the date and time? 
There are some tools available, but at the 
moment, these have not been made available 
for the Raspberry Pi. 

Therefore, if you want to set the date and 
time, you will need to use the command line. 
This is a good excuse for playing around with 
commands, because you can't do much 
damage while messing with the date and time. 

So, let's start messing with the command line. 
You can issue commands just after entering 
your username and password. Or if you prefer 
a graphical environment, you can select the 
desktop main menu item "Accessories" and 
then "LXTerminal". 



+ Why does only Linux use a command line? 
Many users meet their first command line when trying out Linux. They 
wonder why no other operating systems have a command line. 

In fact almost every computer operating system has a command line. For example, 
you can enter commands into Windows by clicking on "Start", clicking on "Run..." 
and entering the word "cmd". 

Your iPhone, your iPad, your Android phone, your modem and your smart TV all 
have command line interfaces hidden somewhere. For somebody who wants to do 
something non-standard with their equipment, this command line is the gateway to 
unlimited access. 

Linux is just different because the command line is not tucked into an obscure 
corner (like in Windows) or hidden completely (like in your iPad). 



If you want to see the current date and time, you should enter the command "date". You should see 
something like 



pi@raspberrypi :~$ date 

Fri Jun 1 09:49:25 BST 2012 



If you wish to change the date/time to June 21 13:45, you could use any of the following 
commands (whichever is more suitable for you) 



pi@raspberrypi :~$ sudo date 06211345 

pi@raspberrypi :~$ sudo date -s "June 21 13:45" 

pi@raspberrypi :~$ sudo date -s "21 June 13:45 2012" 

pi@raspberrypi :~$ sudo date -s "13:45 June 21" 

pi@raspberrypi :~$ sudo date -s "Jun 21 1:45pm" 

pi@raspberrypi :~$ sudo date -s "Next Thursday 13:45" 



Try experimenting with all the different options which can be used. See what happens when you 
enter an invalid date such as June 31 st . 



+ 



What does "sudo" mean? 



J sudo allows you to change things which will affect the complete machine, 
not just one user. Sudo is just like "Run as administrator" on a Windows 
PC. A Linux machine is designed to let the average user work only on 
his/her own files. To be able to change anything else, the user must add sudo to 
the beginning of the command. It is a way to ensure that you don't do something 
silly unless you really want to. 

To see the difference, try entering the date command without sudo at the start. 
You will get an error "Operation not permitted". 



+ 



startx 



Some useful commands 

Here are some commands for you to experiment with. 

If you are a bit nervous about the command line, this might be 
your favourite. It gets you escape to a nice graphical interface. 

Show how much memory is available. 



hostname -I 
1 susb 



Show how much disk space is used. 

Show your IP address. Try this command with your network cable 
connected and disconnected to see the difference. 
Show what is plugged into the USB port. Try this command with 
your mouse connected and disconnected to see the difference. 
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COMPUTER 



MUSIC 




By Dave Spice tJ 
Interesting facts: 

The first computer to sing a song was an IBM 
7094 in 1961. The song was Daisy Bell (as in 
'Daaaisy, Daaaisy, give me your answer, do'). 

The song was also used in the science fiction 
film 2001: A Space Odyssey. The intelligent 
computer Hal 9000 sings the song when he is 
being deactivated by Dave. The song was the 
first thing Hal learnt when he was programmed. 

If you or a family member own an iPhone 4S; 
say to Siri "sing a song to me" and see what it 
does. 

Back story 

It may surprise you to learn that most modern pop 
music involves the use of one or more computers in 
its creation. Styles like Hip Hop, Drum & Bass, 
House, Trance and Dub Step rely heavily on the 
use of computers. The basic idea is that the 
computer is programmed to play sound effects in a 
certain sequence or pattern which becomes a song. 
The sound effects can be anything from a drum 
beat to someone singing. So when you press play, 
the computer itself performs the music as opposed 
to a band. The technique is called sequencing 

The user will need to have an ear for music though 
as a bad sequence can sound like a cats' choir. 
The computer will simply play whatever it's been 
told to play, nothing more. .You could go out and 
spend a lot of money on professional music 
equipment to do this, or you could just download 
free software and do it on your Raspberry Pi for 
nothing! 



What software to use? 

You'll encounter a lot of £ my program is better than 
your program' arguments when you get into making 
music on computers. My advice is to not limit 
yourself to any one program, try them all. You may 
find you are limited by what is available for the 
Raspberry Pi to start with, but in time this will 
improve. The program we're going to use in these 
tutorials is by no means the best program in 
existence, but it is a good place to start. 
The program we are going to use is a tracker 
program. This is a lightweight program that does 
what I described above. You load sound effects, 
called samples, into the program and you then 
program these sound effects into pages of music, 
called patterns, which represent the sequence. 

To can get an idea of the level of music that can be 
achieved, we're going to get the program running 
and use it to play back a few songs. Playing back 
other people's stuff is good fun; I've spent hours 
doing it before. It will give you a lot of cool ideas 
and will hopefully spark your imagination. 

Introducing Schism Tracker 

The program we're going to use is called Schism 
Tracker. 

Instructions (assuming Debian Linux is being used); 

Enter sudo modprobe 

at the prompt to enable 

sound. 

Now enter startx to load the Raspberry Pi 
desktop. 

Open Midori (Start > Internet > Midori) 
Enter this address: 

http : / / goo . gl/ awleA 
Click Save. 

Open File Manager (Start > Accessories > File 
Manager). 

Go to the Pi home folder (house icon on the left). 
You should now see the file: 

schismtrackerpi . tar . gz 



Right click it and select Extract Here from the menu. 
Notice a new folder called schism . 
Open it (double click). 

You should now be looking at a number of files, 
some with a music note icon and one with a cog 
icon (see right). 
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The cog icon is the program, double click it and 
Schism Tracker will start. 
Avoid maximising the window. This will make 
Schism Tracker run slowly. 

If things are working correctly you should see the 
message Using alsa on sdl , see 
below. If you see Using dummy on 
sdl it means you missed out the first line of these 
instructions and sound is not enabled. Go back to 
the command prompt and do this now. 



I E-S E ...DDI I 




Using- als-a on sdl 

Copy^i srh t (c) 2003-2012 S t o r- 1 e 1< & Mrs . B^isJby 
Based on [npulse Tracker Dby Jeffrey law aka. Pulse 
Press Fl JTor copyrigrht and full credits 



Press Enter to continue. Don't be fooled by the 
old-school look and feel of this program. It is fast, 
convenient and has survived for so long for good 
reasons. 

In the world of tracker programs a song file is called 
a module. The key to load a module is F9. You 
should now have the screen below. 



Schism marker 
tonisH Tracker its ■• aai3-<M-33 hull* net a 3 sois iB:±a:aa 



S: CO: 11 




The right portion of the screen is a folder browser to 
load module files, you'll need to navigate into the 
schism folder. You can either use the mouse 
to double click it or use the cursor keys to move the 
selection and press Enter. 
Now a list of the module files will display on the left 
portion of the screen. Either double click one or use 
the cursor keys and press Enter to load. 
Press F5 to play the song. F8 to stop playback. 
Press again at any time to load a different 
module, and again to play it. 
You might listen to some songs and think 1 could 
never do that' - relax. You could. It just takes time, 
patience and practice. The first few songs you 
make might not be great, my first tune sounded like 
noise! But don't let it bother you. Songs don't have 
to be serious either, I once made a terrible tune that 
had Bevis and Butthead vocals in it. 
This is all we're going to do for this tutorial. In the 
next one we will actually program a simple tune. In 
the meantime, just have some fun listening to other 
people's work. To download more module files use 
Midori again and visit http://modarchive.org/ where 
hundreds more songs can be downloaded. Use the 
menu at the top of their site to go to Music > Charts 
> Top Favourites - 1 recommend you listen to the 
first 20 or so in that list (a few you will already have). 
The modarchive.org files come in a compressed zip 
file, so they need to be extracted before you can 
play them in Schism. Right click the zip file > 
Extract Here, then drag the file into the schism 
folder. Press again and you should see it in the 
list. 



Note: Remember that you will need to use the 
sudo modprobe snd_bcm2835 after each reboot. 
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In issue 1 we showed you how to set up 
an Oracle VM VirtualBox of the Linux 
Debian Operating System... 



Following on from last time, we thought we would show you how to write and run python 
programs using your VirtualBox, and a few simple file and folder operations. 





Editing And Running Python Programs 



1. Open Leafpad by clicking on the start button and 
navigate to Accessories > Leafpad. 




2. Let's type a simple python program into Leafpad: 
print "Hello" 




3. Click File>Save As... from the pulldown menu 



^(Untitled) 



Edit Search Options Help 




ctrl+N 

Ctrl+O 
Ctrl+S 



M Print Preview Shift+Ctrl+P 
^ Print... Ctrl+P 

Ctrl+Q 



£||*f Untitled) 



i 



4. Save the program as 'hello.py' 



Name: |hello.py| 
Save in folder; £ user 



t> Browse for other folders 



Character Coding: | Current Locale (UTF-8) 0 LF C 



Q Cancel f^S_ave 



[|§*(Untitled) |gfSave As 

5. Open LXTerminal by clicking on the start button and 
navigate to Accessories > LXTerminal 



Graphics 
O Internet 
- Office 
S Other 
ft Sound & Video 

System Tools 



Q File Manager 
> S Image Viewer 
> 
> 
> 
> 
> 



C4 Leafpad 
l M Root Termi 
Xarchiver 




6. In the LXTerminal type Is' and press enter to see the 
list of files in your 'Home directory'. You can think of 
Home directory as being the Linux version of 'My 
Documents'. You should see a directory called 'Desktop' 
and also your saved hello.py file. 



hello.py 






File Edit Search 


File Edit Jabs Help 


print "Hello"] 


user@debian : Is 
Desktop hello. py 
user@debian : | 

I 








m 


^3_J|£^ hello.py jjj ■ user@dehian: ~ 



NOTE: The Debian LiveCD comes with 
Python version 2.6.6. You can confirm this at 
the LXTerminal prompt by typing 'python -V 
(Make sure that is a capital V not small v) 
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7. Type in 'python hello.py' and press enter to run your 
python program. You should see the word 'Hello' printed 
on the line below. 



hello.py 



_ □ X 



File Edit Search Options Help 



print "Hello"| 




File Edit Jabs Help 



usor@dGbian:-$ Is 

Desktop hello.py 

user@debian : -$ python hello.py 

Hello 

user@debian : ~$ | 



H useng 



^hello.py 

8. You might like to make a directory / folder to keep 
your python programs separate from other files. Type: 
'mkdir python'. Then type 'Is' to check that the new 
directory is there. 




File Edit Jabs Help 



user@debian : -$ Is 

Desktop hello.py 

.user@debian : python hello.py 

Hello 

user@debian:-$ mkdir python 
user@debian : Is 
Desktop hello.py python 
user@debian : | 



hello.py 

9. Close the Leafpad by clicking the X on the top right 
corner. Then in the LXTerminal type: 'mv *.py python'. 
Then type 'Is' - you should see that the 'hello.py' file has 
gone. 



i 



user@de 



File Edit Jabs Help 



Hello 

user@debian : mkdir python 
user@debian : -$ Is 
Desktop hello.py python 
user@debian : mv *.py python 
user@debian : -$ Is 
Desktop python 
user@debian : -$ | 







J user@debian; — | 



'mv *.py python' - means move all files that end with '.py' 
into the directory called 'python'. 



10. Type 'cd python' and then 'Is' to change directory to 
'python' and list the files. Make sure that hello.py got 
moved into the 'python' directory. 



userradebian: -/python 



File Edit Jabs Help 



Desktop hello.py python 
user(adebian : -$ mv *. py python 
user@debian : -$ Is 
Desktop python 
user@debian : ~$ cd python 
user(3debian : ~/python$ Is 
j hello . py 

■ user@debian : ~/python$ | 



luser@debian: 



11. Type 'cd ..' to move up one directory level (Back to 
the Home directory). Type 'Is' again to check where you 
are. You should see Desktop and python directories. 





user@debian: — 




File Edit Jabs Help 



Desktop python 
user(adebian : cd python 
user@debian : -/python$ Is 
hello . py 

user@debian : -Vpython$ cd 
user(adebian : Is 
Desktop python 
"user@debi.an : -$ | 




I user@debian: 



12. To remove the python directory (delete it) type in 'rm 
python -R'. Then type 'Is' to see that the python directory 
is gone. The '-R' means recursive - deletes any files or 
directories that are inside the python directory as well. 



user@debian: 



File Edit Jabs Help 



I hello . py 

user@debian :~/python$ cd .. 
user@debian : -$ Is 
Desktop python 
user^debian : -$ rm python -P. 
user@debian : ~$ Is 
Desktop 

user^debian : ~$ | 



H user@debian 

13. To close the LXTerminal type 'exit'. 



Desktop python 

user@debian:-$ rm python - P, 
user@debian : -$ Is 
Desktop 

user@debian : exit| 




Well done! Look out for more next month. 



Article by Jaseman 



the , 
python 

pit 



I'M 




NOTE: For these examples, you will need both Python and Pygame installed on your computer. 

We should start by opening a window that is suited to displaying graphical output, rather than just the 
very simple text output that you get from the terminal or command line: 

• # OPEN A PYGAME GRAPHICS WINDOW t 

# By Jaseman - 03 May 2012 
import os, pygame 

0 from pygame. locals import * 4 
pygame. init() 

clock = pygame. time. Clock() 

# os.environ[ , SDL_VIDEO_WINDOW_POS'] = 'center 1 f 

# This title appears along the top of the graphics window 
pygame. display. set_caption("The Title Of My Program") 

0 # Opens a graphics window called 'screen 1 with width 400 height 200 4 
screen = pygame. display. set_mode([400,200], 0,32) 
pygame. time. wait(5000) # A 5 second pause before ending the program 



When you run this program you should see a black rectangular window appear with a title along the 
top. All of the pygame graphics will be drawn inside this window. When deciding what size the 
graphics window should be - Consider that some people that use your program might have smaller 
monitor screens or televisions than you. If you make the window too big, the edges may not be visible 
on small screens. You also need to think about what your program will be displaying. This will help in 
deciding the best shape and size for your graphics window. 



Try changing the width and height from 
400x200 and run the program again to see 
the results. 



PYTHON VERSION: 3.2.2 
PYGAME VERSION: 1.9.2a0 
O.S.:Win7 
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This time we have added some Surface fill commands to paint the entire screen surface in colour. The 
color values are defined in amounts of Red, Green and Blue - We call these RGB color values. 



# DISCO SCREEN 

# By Jaseman - 10th May 2012 
import os,pygame 

from pygame. locals import *; pygame.init() 
clock = pygame. time. Clock() 

os-environ['SDL_VIDEO_WINDOW_POS'] = 'center 1 
pygame. display. set_caption("Disco Screen 11 ) 
screen = pygame. display. set_mode([400, 200], 0,32) 

screen.fill(( 255,0,0) );pygame.display.update( );pygame. time. wait( 2000) 
screen.fill(( 255,255,0) );pygame. display. update( );pygame. time. wait( 2000) 
screen.fill( (0,255,0) );pygame.display.update( );pygame. time. wait( 2000) 
screen.fill((0,0,255));pygame. display. update();pygame. time. wait(2000) 
screen.fill((0,255,255));pygame. display. update( );pygame. time. wait( 2000) 
screen.fill(( 255,0,255) );pygame. display. update( );pygame. time. wait( 2000) 
screen.fill(( 255,255,255) );pygame. display. update( );pygame. time. wait( 2000) 
screen.fill( (0,0,0) );pygame.display.update( );pygame. time. wait( 2000) 



The amount of Red, Green or Blue can be '^^^ 0 n n 

any number between 0 and 255-0 being j^S^L , [ 

very dark and 255 being very bright. o.s.:Win7 

Try experimenting with different amounts of Red, Green and Blue. 



You can visit this website which will make it easier to find the right RGB values for the colour you are 



looking for: http://www.colorpicker.com/ 

Move the dot around within the shaded square 
and drag the arrows to the right up and down. 
When you find a colour you like, note down the 
R: G: and B: numbers that are listed to the right 
hand side. You can ignore the H: S: and B: 
ones. 



OJ:r 



# ED1BGA 




(continued over page...) 

27 



In this example we draw some basic geometric shapes onto the screen - a circle, a rectangle, a triangle 
(polygon) and a line. 



# GEOMETRIC SHAPES 

# By Jaseman - 10th May 2012 
import os,pygame 

from pygame. locals import *; pygame.init() 
clock = pygame. time. Clock() 

os.environ['SDL_VIDEO_WINDOW_POS'] = 'center 1 
pygame. display. set_caption("Geometric Shapes") 
screen = pygame. display. set_mode([400, 200], 0,32) 

# Draw a CIRCLE on screen in (red) at (x,y) coords (60,70) of diameter 40 
pygame. draw. circle(screen,(255,0,0), (60, 70),40) 

pygame. display. update( );pygame. time. wait( 2000) 

# Draw a RECTANGLE on the screen in (yellow) at (x,y,width,height) 
pygame. draw. rect(screen,(255,255,0), (70,70,1 20,60)) 

pygame. display. update( );pygame. time. wait( 2000) 

# Draw a POLYGON on the screen in (green) at points ((x,y),(x,y),(x,y)) 
pygame. draw. polygon(screen,(0,255,0),(( 120, 100), (240,40), (220, 130))) 
pygame. display. update( );pygame. time. wait( 2000) 

# Draw a LINE on the screen in (blue) from (x,y),(x,y),width 
pygame. draw. Iine(screen,(0,0,255),( 10,150), (370,30), 10) 
pygame. display. update();pygame.time.wait( 10000) 



PYTHON VERSION: 3.2.2 
PYGAME VERSION: 1.9.2a0 



To really get to grips with these new 
commands, try adding more circles, lines, 

rectangles and polygons. Change the o ^winz" ° " ^ 

coordinates and RGB values and see if you 
can draw a picture. 



Notice how the first shapes to be drawn go underneath the later ones. Each 
shape is drawn in the order that they are listed. 

| The polygons don't have to be triangles - you can add as many x,y points as 

c» python" youlike - 



pit 
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This simple house picture is created using some of the pygame draw commands: 



# THE HOUSE 

# By OtheOjudgeO - 29th May 2012 

import os, pygame; from pygame. locals import * 
pygame. init(); clock = pygame. time. Clock( ) 

os.environt'SDL^VIDEO^WINDOW^POS'] = 'center 1 

d = pygame. draw # this will save us writing 'pygame. draw 1 many times 

pygame. display. set_caption("The House") 

# Define some colors 

white = (255,255,255); black = (0,0,0) 

bg = (186, 213, 48); walls = (157, 109, 9) 

door = (151, 36, 9); doorjight =(181, 132, 14) 

# coordinates of glass panes 

windows = [(82, 125), (82, 215), (262, 125), (262, 215)] 
#init screen 

screen = pygame. display. set_mode([423,347], 0,32) 
#the walls 

screen. fill(bg) #fill the background screen colour 
d.rect(screen, black, (60, 102, 305, 225) ) 
d.rect(screen, walls, (73, 114, 280, 200) ) 

#the roof 

d.polygon(screen,black,((35,112),(121,12),(296,12),(321, 36),(321, 12), 
(361, 12),(361, 84),(384, 112))) 

d.polygon(screen,walls,((62,101),(128,23),(289,23),(334, 69),(334, 25), 
(348, 25),(348, 88),(361, 101))) 

#the door 

d.rect(screen, black, (167, 198, 84, 125 )) 
d.rect(screen, door, (179, 210, 60, 101 )) 
d.rect(screen, black, (185, 216, 50, 54 )) 
d.rect(screen, door_light, (191, 222, 38, 41 )) 
d.circle(screen,black,(209,277),5) 

#the windows 

for window in windows: 

d.rect(screen, black, (window[0], window[l], 76, 76) ) 
d.rect(screen, white, (window[0] + 12, window[l] + 12, 22, 22) ) #tl 
d.rect(screen, white, (window[0] + 42, window[l] + 12, 22, 22) ) #tr 
d.rect(screen, white, (window[0] + 12, window[l] + 42, 22, 22) ) #bl 
d.rect(screen, white, (window[0] + 42, window[l] + 42, 22, 22) ) #br 

#lets see the end result 
pygame. display. update() 
pygame. time. wait( 10000) 
pygame. quit() 



PYTHON VERSION: 3.2.2 
PYGAME VERSION: 1.9.2a0 
O.S.:Win7 ^ -J,f> 




'Nice concept, nice layout, nice 
graphics, nice mag overall.' 

Dave_G_2 

'Looks great, congrats, can"t 
wait for the next one. ' 

kirbyman62 

Hey, I love the design of the 
mag - very pro. 

pifan 

'Just had a scan through the 
MagPi. It looks really good; 
seems like a great deal of 
thought and effort has gone into 
it' 

budgieboy 

Really like what you did for a 
first issue! 

Rek 

'Excellent! I enjoyed reading it. 
Now just waiting to hear from RS 
in South Africa when I can move 
from the waiting list to "ordered"' 
.^^^ Kaspaas 



attractive. 



skimmed it so far, but my overall 
impression is that it is very 
professionally done, kudos. ' 

boley 



just read the mag and its 
fascinating. VERY well done' 
M secretreeve 



'Absolutely excellent - much 
better than I expected. In 
particular the Python Pit is just 
what beginners need.' 

bredma 



'Hi there, congrats with your first 
issue - well done!' 

teh_orphn 

'What a terrible site. Sorry. 
When I finally manage to get the 
PDF and read it in xpdf, it's OK, 
but rather primitive. 

GordonH 



F, 



'Well done. You'vi 
job.' 



a good 



trikidiki 



'It's a great start; one hell of a lot 
better than I could have done. ' 



nH 



7 quickly read thought it and was 
pleasantly surprised. Its well 
laid out, hits the target markets 
(nice child friendly areas for 
coding) and has some nice 
content' 

JoeDaStudd 

'Thanks very much for providing 
this mag, I'm very much looking 
forward to further issues and to 
see how it develops.' 

Forrrge 




rurwin 



'Thanks for a great first issue. 
Personally I liked the PDF 
version and I printed out and 
stapled together a few copies 
and left them around the 
staffroom of the school I work at. 
They got a lot of interest. Keep 
up the great work! 

rubikwizard 

'You have done something 
amazing here. I'm 15 and I must 
say I buy magazines for a fiver 
with less engrossing content 
than this. I found every article 
interesting, and after showing 
my friends they too had a great 
read.' 

FullXion 

'kudos on the first issue, very 
well put together for a first issue, 
and i'm sure if the momentum 
keeps going there will be some 
interesting stuff in there as you 
cover peoples projects and 
suchlike. ' 

ArborealSeer 

While I didn't learn anything 
groundbreaking (I'm a software 
developer) I did learn a few new 
things about Linux and think the 
coding tutorials are pitched at 
the perfect level for a beginner! 
Well done guys!' 

Tavalin 
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